home *** CD-ROM | disk | FTP | other *** search
/ Quick PC 62 / Quick PC 62.iso / Programs / 32bit.Service.Monitor.v9.54.01.WinALL / 32bssx.exe / MANUAL.TXT < prev    next >
Encoding:
Text File  |  2003-05-09  |  14.2 KB  |  382 lines

  1.                          32bit Service Monitor
  2.  
  3.                            Table of Contents
  4.  
  5. --------------------------------------------------------------------------
  6. Subject:                                                      Item Number:
  7. --------------------------------------------------------------------------
  8. 1. About This Manual                                                     1
  9. Buttons and Dialog Box Items                                             1
  10.  
  11. 2. Getting Started                                                       2
  12. Installing 32bit Service Monitor                                         2
  13.  
  14. 3. [Global Options] Tab                                                  3
  15. Global Options                                                           3
  16. Session Log File Status                                                  3
  17.  
  18. 4. Configure/Monitor Services                                            4
  19. Service X ]>                                                             4
  20. Service X                                                                4
  21. Define Service                                                           4
  22. Configure Alerts                                                         4
  23. Select Alerts                                                            4
  24. Status Area                                                              4
  25.  
  26. 5. Activity Log                                                          5
  27. Activity Log                                                             5
  28.  
  29. 6. Menu Items                                                            6
  30. Exit                                                                     6
  31. SessionLog                                                               6
  32. Sound                                                                    6
  33. Help                                                                     6
  34. Register                                                                 6
  35. --------------------------------------------------------------------------
  36.                    End Table of Contents
  37.  
  38.  
  39. Item 1 - About This Manual
  40.  
  41. - Buttons and Dialog Box Items
  42.  
  43. While reading this manual, words in square brackets [ ] will be in 
  44. reference to [Buttons and Dialog Box Items].
  45.  
  46.  
  47. Item 2 - Getting Started
  48.  
  49. - Installing 32bit Service Monitor
  50.  
  51. Go to http://www.electrasoft.com/32bs.htm and download the newest version.
  52. During installation, it will ask you for your registration name and email
  53. address. Enter the name and email address you want 32bit Service Monitor
  54. to be registered to. This is the name and email address that you will be
  55. known to us at ElectraSoft as.
  56.  
  57.  
  58. Item 3 - [Global Options] Tab
  59.  
  60. - Global Options
  61.  
  62.   - Use System Tray
  63.   Check this if you want 32bit Service Monitor to minimize to the system
  64.   tray instead of the Windows Task Bar.
  65.  
  66.   - Hide in Tray at Startup if [Tray] is Checked
  67.   Check this if you want 32bit Service Monitor to hide in system tray at
  68.   startup.
  69.  
  70.   - Show only first line of response in Activity Log
  71.   If you are checking a large file, like index.htm, it may not be
  72.   necessary to fill the Activity Log with the contents of this file.
  73.   check this check box so it will only show a one line response.
  74.  
  75.   - Max services examined simultaneously
  76.   This is the number of services that will be checked at simultaneously.
  77.   ie: If you have 20 services being monitored and when they are checked,
  78.   if you only want to check 2 at one time then check the next 2 when those
  79.   checks have completed, you would set this value to [2].
  80.  
  81.   - Max number of services available
  82.   This is the number of services that will be able to br monitored at
  83.   the same time. The number of services available will be the number of
  84.   service tabs you will be able to select under [Configure/Monitor
  85.   Services]
  86.  
  87.   Deciding how many services to select:
  88.   Each service that you allow uses considerable memory and resources.
  89.   Whether or not you fill in the service forms or run them, they use
  90.   approximately the same amount of memory. So if you need to monitor
  91.   more services, select as many as you need. If you need less services,
  92.   you should select less.
  93.  
  94. - Session Log File Status
  95.  
  96.   - No session log file
  97.   Select this if you do not want 32bit Service Monitor to keep any session
  98.   logs.
  99.  
  100.   - One log file, append to it each session
  101.   Select this if you want 32bit Service Monitor to keep one session log
  102.   and append each session's log to it.
  103.  
  104.   - New log file with new name each session
  105.   Select this if you want 32bit Service Monitor to create a new session
  106.   log for each session of 32bit Service Monitor.
  107.  
  108.   - Delete all Session Log files on exit
  109.   Check this to have 32bit Service Monitor delete any session log files
  110.   saved. This will take place upon exiting 32bit Service Monitor.
  111.  
  112.  
  113. Item 4 - [Configure/Monitor Services] Tab
  114.  
  115. - Service X ]>
  116.  
  117. This is the first item in the tab. It is a drop down list box. You can
  118. select which service to view/configure with this list. The following
  119. settings for the [Configure/Monitor Services] Tab will be in all of the
  120. Service X tabs. Where X is a number between 1 and the [Max number of
  121. services available], which is selected in the Global Options.
  122.  
  123.  
  124. - Service X
  125.  
  126. These are tabs 1 - 20 that are services you can choose to view/configure.
  127. In any of these tabs, the following fields and information will be there:
  128.  
  129.  
  130. - Define Service
  131.  
  132.   - Service Name
  133.   This is where you can specify the name of the service you want to
  134.   monitor. This is for your reference, so you can identify a certain
  135.   service.
  136.  
  137.   - Host/Site/IP
  138.   This is where you specify the host/IP address of the service you want to
  139.   monitor. ie: If you wanted to monitor youw web site at
  140.   http://www.mygreatsite.com , you would enter:
  141.   [www.mygreatsite.com] in this field (without the square brackets).
  142.  
  143.   - Command/Script (optional)
  144.   You can type in a single command or a reciprocal script.
  145.  
  146.   Running a Command/Script:
  147.   If the service checks ok, then it looks to see if there is a command or
  148.   script to be run. If there is no command or script, the service check
  149.   returns and logs an ok. If there is a command or script, it must also
  150.   check ok if the service check is to log an ok.
  151.  
  152.   Script Format:
  153.   The odd lines (1,3,5,7,etc) are sent to the service. The even lines
  154.   (2,4,6,8,etc) are the responses that you are expecting from the service.
  155.   In most cases only the significant characters of the response are
  156.   needed. For instance, if the expected response is [220 Please enter your
  157.   user name], you would only need to put 220 as the response line. Then
  158.   you can send an optional QUIT and expect back a response of [221-You
  159.   have transferred 0 bytes in 0 files. See the port [21 ftp] example
  160.   below.
  161.  
  162.   How the Command/Script Works:
  163.   The first line is sent to the service. The next line is compared to the
  164.   response from the service. If the response is the same as the script
  165.   line, the service is checked as ok. If not, it is logged as an error. If
  166.   the script has an uneven number of lines, the script will always return
  167.   ok, because being that the last expected response is not defined, the
  168.   response is logged but it is not considered while determining the error
  169.   condition.
  170.  
  171.   Command/Script example for port [80 http]:
  172.   ---- start script ----
  173.   GET /
  174.   200
  175.   ---- end script ----
  176.   This script will read your default home page. This is usually
  177.   index.html, index.htm, or default.html. GET /thispage.htm will
  178.   read thispage.htm and GET /thispage.html will read thispage.html.
  179.  
  180.   If the script is successful, it will return with something like:
  181.   HTTP/1.1 200 OK
  182.   If the script fails, it will return with something like:
  183.   HTTP/1.1 302 Found
  184.  
  185.   The format may change a little from one server to another.
  186.   32bit Service Monitor will resolve this for you. You are only
  187.   interested in the numbers 200 and 302.
  188.  
  189.   Command/Script example for port [21 ftp]:
  190.   ---- start script ----
  191.   USER UserName
  192.   220
  193.   PASS PassWord
  194.   230
  195.   QUIT
  196.   221
  197.   ---- end script ----
  198.  
  199.   Command/Script example for port [25 smtp]:
  200.   ---- start script ----
  201.  
  202.   220
  203.   QUIT
  204.   221
  205.   ---- end script ----
  206.   Note that the first line of this script can be a blank line. If we make
  207.   a good connection, we may not need to send a command to get a responce.
  208.   As with an SMTP, we need to get the 220 responce to the succsessful
  209.   connect. So the first line of the Script should be blank. If it is
  210.   blank, we will not send the command, but we will receive the SMTP 220
  211.   responce to the connect. Then we send the command QUIT, and the SMTP
  212.   will respond with a 221.
  213.  
  214.   If you have a one line command or script ie: [GET /]. The command will
  215.   show in the activity log. The response will also show in the activity
  216.   log, but the check will always be seen as checking ok. This ok scenario
  217.   assumes that everything else was ok up to the point of running the
  218.   command or script. If there is an error making connect with the service
  219.   before the script is run, the check will return an error. When the user
  220.   define number of failed or errored checks are satisfied, the user
  221.   defined alerts will be activated.
  222.  
  223.   - Port (0 - 65535)
  224.   Port is where you can specify the port number on the remote [Host, Name,
  225.   or IP] that is being monitored. The port used for a web site is usually
  226.   port [80 http]. An FTP site is usually on port [21 ftp]. In the list of
  227.   port numbers, the service name usually used on that port appears next to
  228.   the number.
  229.  
  230.  
  231. - Configure Alerts
  232.  
  233.   - Minutes between checks
  234.   This is where you specify the number of minutes between checks on the
  235.   specified service being monitored.
  236.  
  237.   - Failed checks before alert
  238.   This is where you specify the number of failed checks before you are
  239.   alerted.
  240.  
  241.   - Timeout, seconds (20)
  242.   This is where you specify the amount of time to keep trying to check a
  243.   service. The default is 20 seconds. If 20 seconds is specified, the
  244.   service will be given 20 seconds to respond before being counted as a
  245.   failed check.
  246.  
  247. - Select Alerts
  248.   
  249.   In order from top to bottom and left to right:
  250.  
  251.   - Error Sound
  252.   Check this to have 32bit Service Monitor play the Windows default error
  253.   sound when the service is down.
  254.  
  255.   - Play WAV file
  256.   Check this to have 32bit Service Monitor play a specified WAV file when
  257.   the service is down.
  258.  
  259.   - Repeatedly
  260.   Check this to have 32bit Service Monitor play the specified sound in a
  261.   continuous loop until the service is back up or until you uncheck it.
  262.  
  263.   - Browse
  264.   Click this button to browse and select a WAV file to play if
  265.   [Play WAV file] is checked.
  266.  
  267.   - Test
  268.   Click this button to test the sound currently selected.
  269.  
  270.   - Show Alert Message Box
  271.   Check this to have 32bit Service Monitor pop up an alert window when the
  272.   service is down.
  273.  
  274.   - Send Email at Beginning of Alert
  275.   Check this checkbox to have 32bit Service Monitor email a message to
  276.   you, telling you when the service goes down. This message can be
  277.   emailed to one email address or to a whole list of email addresses.
  278.  
  279.   - Edit Email
  280.   Click this button to edit the email message that will tell you the
  281.   service is down.
  282.  
  283.   - Send Email at Ending of Alert
  284.   Check this checkbox to have 32bit Service Monitor email a message to
  285.   you, telling you when the service is back up. This message can be
  286.   emailed to one email address or to a whole list of email addresses.
  287.  
  288.   - Edit Email
  289.   Click this button to edit the email message that will tell you the
  290.   service is back up.
  291.  
  292.   - Pager
  293.   Check this to have 32bit Service Monitor notify you by a pager when the
  294.   service is down.
  295.  
  296.   - Page Setup
  297.   Click this button to edit the settings for the pager and modem settings.
  298.  
  299.   - Execute Program
  300.   Check this to have 32bit Service Monitor start a specified program when
  301.   the service is down.
  302.  
  303.   - Browse
  304.   Click this button to browse and select an executable file to run if
  305.   [Execute Program] is checked.
  306.  
  307.   - Test
  308.   Click this button to test the executable currently selected.
  309.  
  310.  
  311. - Status Area
  312.  
  313.   - Monitor Service
  314.   When this is checked, the current service will be monitored.
  315.  
  316.   - Reset
  317.   Click this button to: reset the number of failed checks to 0, check
  318.   the service right away, and start the count down to check the servicefrom the top.
  319.  
  320.   - Errors and Alert
  321.   Errors<X> tells you the number of times the service has been down on a
  322.   check. Where X is the number of times.
  323.   
  324.   Alerts<X> tells you how many failed checks is required before alerting
  325.   you that the site is down.
  326.  
  327.  
  328. Item 5 - [Activity Log] Tab
  329.  
  330. - Activity Log
  331.  
  332. Here is where you will see the activity log since 32bit Service Monitor
  333. was started. When you exit and start the program, the activity log will
  334. clear and start a new log in here for the session.
  335.  
  336.  
  337. Item 6 - Menu Items
  338.  
  339. - Exit
  340.  
  341. Click this to exit 32bit Service Monitor.
  342.  
  343.  
  344. - SessionLog
  345.  
  346. Click this to open the current Session Log/Activity Log in your Windows
  347. default text editor.
  348.  
  349.  
  350. - Sound
  351.  
  352.   - Sound, Enable/Disable
  353.   When [Disable] is clicked, the sound alerts in 32bit Service Monitor
  354.   will be disabled. If there are any sounds queued to be played from an
  355.   alert, the events will be deleted and the sounds will not be played. The
  356.   next time the Sound menu is brought down, it will read [Enable] instead
  357.   of [Disable], or vice versa.
  358.  
  359.   - Sound, Flush Queue
  360.   When [Flush Queue] is clicked, any sound that is queued to be played due
  361.   to an alert, will be deleted and the sounds will not be played.
  362.   
  363.   
  364. - Help
  365.  
  366. Click this to bring up the menu of help and information items.
  367.  
  368.  
  369. - Register
  370.  
  371. If you are an unregistered user (If you have not paid for 32bit Service
  372. Monitor), then you will see this menu item. Click it if you wish to
  373. register (Pay for 32bit Service Monitor).
  374.  
  375. You can try 32bit Service Monitor before you buy it. If you want to
  376. continue using this software after trying it, you must purchase it by
  377. registering it with ElectraSoft. This means you have a chance to test the
  378. performance of 32bit Service Monitor before committing yourself to buying
  379. it. Before paying, you will only be able to monitor one service at a time.
  380. After you pay ElectraSoft for the use of [32bit Service Monitor], you will
  381. be able to monitor up to five services at a time.
  382.